WIP- FujiNet Benutzerhandbuch

← Zurück zum Forum

Ich arbeite derzeit an einem Benutzerhandbuch für den ATARI FujiNet.

Es wird mit Docbook geschrieben und auf GitHub gehostet: https://github.com/FujiNetWIFI/fujinet-manuals

Die Gründe, warum ich es in diesem Format schreibe:

  • DocBook kann mehrere Ausgabeformate wiedergeben. Ich beabsichtige, PDF, EPUB und HTML zu verwenden. Der Stil ist von der Struktur getrennt. Das Standard-Stylesheet für PDF definiert ein druckbares Formular, das extrem professionell aussieht. Die Formatvorlage für HTML wird auf XSLTNG basieren. Dies erzeugt sehr sauberes HTML, sehr sauberes CSS und sieht auch sehr professionell aus. Internationalisierung ist möglich, um in andere Sprachen zu übersetzen.

Ich habe genug von einem Stylesheet getan, die ich eine Kopie des Dokuments unten gerendert haben.

Was haltet ihr davon?

-Thom

Anhänge:

Finde ich klasse. Wenn man bedenkt wie beliebt das FujiNet ist, dann wird das Handbuch sicher gut ankommen.

Perfekt. Wenn´s jetzt noch ne Schwarz/Rot/Goldene Flagge zum Sprache umschalten gäbe.... 😁 Aber das was ich bis jetzt überflogen habe, ist gut zu verstehen. Ich denke auf das Handbuch hat die Atari-Gemeinde gewartet. HW-Unterschiede, Firmwareupdate, Links werden vermutlich noch kommen? Gruß Wolfgang

Ich gehe davon aus, dass dieses Handbuch mindestens ein paar hundert Seiten umfassen wird. Ich habe so viele Inhalte, die ich schreiben muss. Jeder, der helfen kann, bitte tun, das Handbuch ist offen für alle über GitHub zusammenarbeiten.

working-on-docs.png

-Thom

Anhänge:

Thom lässt gerade Anleitungen komplett durch die Claude KI erstellen.

Als Basis dient der Quellcode(!), aus dem die KI sich die zu beschreibenden Punkte und weitere Informationen holt. Das Layout und die Fonts zieht die KI aus bestehender Doku für das jewilige System.

Kleine Sneak-Previews:

fujinet-owners-guide-400-800.pdf AtariSeite.png

fujinet-getting-started-apple2-FIRST-DRAFT.pdf AppleSeite.png

Ein paar Zitate von ihm zu den Fähigkeiten der KI - schnell mittels DeepL übersetzt:

Die Dokumentation wird DIREKT AUS DEM QUELLCODE IM REPO erstellt.

Ich war fest darauf eingestellt, ihm einen Stapel Screenshots zu füttern, aber es war so: „Nee, da werden illustrierte Figuren verwendet, also mache ich sie selbst.“ Es hat alle Illustrationen erfasst, die schriftgesetzt waren, hat im Quellcode nachgeschaut und die Bildschirme von Hand rekonstruiert.

Das Bild vom Fujinet wurde aus unseren STL-Dateien erstellt.

Das System hat Bluetooth-Code für SIO2BT erkannt, obwohl wir es deaktiviert hatten. Dies wurde auf der Seite "UND ES GIBT NOCH MEHR" vermerkt.

Es hat ganz von selbst erkannt, dass man eine CAS-Datei in Slot 8 einlegen muss.

Meine Güte, sogar die Seite „Was tun, wenn es nicht funktioniert?“ ist richtig. „DER COMPUTER STARTET EIN ALTES PROGRAMM ANSTELLE VON CONFIG“ Das ist ein Feature... MEIN ECHTES LAUFWERK UND FUJINET STREITEN SICH UM LAUFWERK 1... WO IST MEIN AUSDRUCK HINGEKOMMEN? ICH HABE EIN SPIEL GESTARTET UND ERHALTE EINEN BLAUEN BILDSCHIRM, MÜLL ODER BASIC. Halte die OPTION-Taste gedrückt.

Im Moment läuft es wie geschmiert mit dem Apple II, wobei das Apple //c-Benutzerhandbuch als Grundlage dient. Ich habe dem Apple2-Stream einen Stapel Schriftarten übergeben, mit der ausdrücklichen Anweisung, die Schriftarten so genau wie möglich abzugleichen. Es hat Apple Garamond, Century Std. korrekt erkannt...

Alle CONFIG-Bildschirme sind direkt in der Apple-II-ROM-Schriftart gesetzt – für dieses Handbuch sind keine Screenshots erforderlich.

Anhänge: